home *** CD-ROM | disk | FTP | other *** search
/ BCI NET 2 / BCI NET 2.iso / archives / utilities / shell / requestfile.lha / RequestFile / RequestFile.doc < prev    next >
Encoding:
Text File  |  1994-11-30  |  5.4 KB  |  140 lines
  1.  
  2.  
  3.                                RequestFile 37.4
  4.                                ================
  5.  
  6.  
  7.                           Copyright 1994 Simon Dick
  8.  
  9.  
  10. Introduction
  11. ============
  12.  
  13. This program is based on the RequestFile program which comes with Workbench
  14. 3.0 and higher. This version works with Workbench 2.0 as well as the higher
  15. Workbench. Unfortunately, I can't make this program completely compatible
  16. with the Workbench 3.0 version when it is run under Workbench 2.0 as some
  17. of the features in the asl.library aren't available under Workbench 2.0 and
  18. you need Workbench 2.1 or higher to have all the functions.
  19.  
  20.  
  21. System Requirements
  22. ===================
  23. RequestFile needs Kickstart 2.04 or higher and asl.library V37 or higher.
  24.  
  25.  
  26. Usage
  27. =====
  28.  
  29. The command line syntax is exactly the same as the Commodore version:
  30.         DRAWER,FILE/K,PATTERN/K,TITLE/K,POSITIVE/K,NEGATIVE/K,
  31.         ACCEPTPATTERN/K,REJECTPATTERN/K,SAVEMODE/S,MULTISELECT/S,
  32.         DRAWERSONLY/S,NOICONS/S,PUBSCREEN/K
  33.  
  34.         DRAWER          This allows you to specify the drawer which the file
  35.                         requester should start up in.
  36.         FILE            This allows you to specify the file which the file
  37.                         requester initially shows.
  38.         PATTERN         This adds a pattern gadget to the file requester and
  39.                         puts the pattern you supply in it.
  40.         TITLE           This allows you to specify the title of the file
  41.                         requester.
  42.         POSITIVE        This allows you to specify the text for the positive
  43.                         gadget (the one on the left). If you are running
  44.                         Workbench 2.0 (as opposed to Workbench 2.1 or
  45.                         higher) then the text can only be a maximum of 6
  46.                         characters long.
  47.         NEGATIVE        The same as the above except that you can change the
  48.                         negative gadget (the one on the right). The length
  49.                         limit mentioned above also applies here.
  50.         ACCEPTPATTERN   This allows you to give the file requester a
  51.                         pattern. Only files which match this pattern will be
  52.                         displayed. (Workbench 2.1+ only)
  53.         REJECTPATTERN   This allows you to give the file requester a
  54.                         pattern. Only files which don't match this pattern
  55.                         will be displayed. (Workbench 2.1+ only)
  56.         SAVEMODE        This switches the file requester into save mode,
  57.                         where the background colour is altered and you
  58.                         aren't allowed to double click a file to select it.
  59.         MULTISELECT     This switch tells RequestFile to turn the file
  60.                         requester to multiselect mode, this is where the
  61.                         user can select more than one file at the same time
  62.                         by shift clicking (selecting the file while the
  63.                         shift key is being held down) on any files.
  64.         DRAWERSONLY     This tells the file requester to only display
  65.                         directories. There is no file gadget on the
  66.                         requester.
  67.         NOICONS         This option tells the file requester to not display
  68.                         any icons (#?.info). (Workbench 2.1+ only)
  69.         PUBSCREEN       This allows you to give the file requester the name
  70.                         of a public screen to open on. (Workbench 2.1+)
  71.  
  72.  
  73. Distribution
  74. ============
  75.  
  76. RequestFile is freely distributable as long as both the program file and
  77. this documentation file are distributed together.
  78. The only exception to this is if you want to use RequestFile as part of
  79. another project. In this case you are allowed to include just the program
  80. file as long as you mention that it is Copyright by me somewhere.
  81.  
  82.  
  83. History
  84. =======
  85.  
  86. RequestFile 37.4 (30 November 1994) 2096 bytes
  87.    Recompiled using Amiga E V3.0b
  88.  
  89. RequestFile 37.3 (1 October 1994) 2192 bytes
  90.    Recompiled using Amiga E V2.1b
  91.    Hopefully fixed problem with returning random result codes when
  92.      exiting.
  93.  
  94. RequestFile 37.2 (23 August 1994) 2192 bytes
  95.    Implemented the multiselect feature of the Commodore RequestFile.
  96.    Fixed bug which meant that the pattern gadget would never be shown
  97.     if you used the PATTERN option.
  98.    Fixed slight bug which happened under V37 of the asl.library, if you
  99.     didn't specify the POSITIVE option then the left hand gadget would
  100.     be blank.
  101.    Same as above only for the NEGATIVE gadget. These problems didn't
  102.     happen using V39 of the asl.library so I assumed it would be the same
  103.     under all versions.
  104.  
  105. RequestFile 37.1 (15 August 1994) 1796 bytes
  106.    Initial release
  107.  
  108.  
  109. Author
  110. ======
  111.  
  112. This program was written by Simon Dick using Amiga E V2.1b. The manual was
  113. written using EdWord Pro.
  114.  
  115. If you have any comments, bug report, etc. to do with this program then I
  116. can be contacted at:
  117.  
  118.         31 Salisbury Road
  119.         Bexley
  120.         Kent DA5 3QE
  121.         England
  122.  
  123. or from the beginning of October 1994 to the end of June 1995 during
  124. term time:
  125.  
  126.     Avon Way House 2.3/B
  127.     Avon Way
  128.     Colchester CO4 3TZ
  129.     England
  130.  
  131. Disclaimer
  132. ==========
  133.  
  134. This software is provided as-is, without warranty of any kind, either
  135. expressed or implied. In no event will the author be liable for direct,
  136. indirect, incidental or consequential damages or data loss resulting from
  137. the use or application of this software. The entire risk as to the results
  138. and performance of this software is assumed by the user.
  139.  
  140.